﻿<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <link href="stable/static/css/site.css" rel="stylesheet" type="text/css">
    <link href="stable/static/css/print.css" rel="stylesheet" type="text/css" media="print">
    <link href="stable/static/css/prettify.css" rel="stylesheet" type="text/css">
    <link href="//www.google.com/images/icons/product/chrome-16.png" rel="icon" type="image/ico">
    <title>清单文件版本 - chrome插件中文开发文档(非官方)</title>
  </head>
  <body>
    <a id="top"></a>
    <div id="header">{Header content}</div>
    <a id="gc-topnav-anchor"></a>
    <div id="gc-topnav">
      <h1>chrome插件中文开发文档(非官方)</h1>
      <ul id="home" class="gc-topnav-tabs">
        <li id="home_link">
          <a href="index.html" title="Google Chrome Extensions home page"><div>主页</div></a>
        </li>
        <li id="docs_link">
          <a href="docs.html" title="Official Google Chrome Extensions documentation"><div>文档</div></a>
        </li>
        <li id="faq_link">
          <a href="faq.html" title="Answers to frequently asked questions about Google Chrome Extensions"><div>常见问题</div></a>
        </li>
        <li id="samples_link">
          <a href="samples.html" title="Sample Extensions (with source code)"><div>示例</div></a>
        </li>
        <li id="group_link">
          <a href="http://groups.google.com/a/chromium.org/group/chromium-extensions" title="Google Chrome Extensions developer forum"><div>google群组(英文)</div></a>
        </li>
        <li id="so_link">
          <a href="http://stackoverflow.com/questions/tagged/google-chrome-extension" title="[google-chrome-extension] tag on Stack Overflow"><div>还有问题?(英文)</div></a>
        </li>
      </ul>
    </div>
    <div id="gc-container">
      <div id="gc-sidebar">
        <ul 
            class="level1 ">
          <li class="level2">
                <a href="getstarted.html" class="level2 ">入门</a>
          </li>
          <li class="level2">
                <a href="overview.html" class="level2 ">概述</a>
          </li>
          <li class="level2">
                <a href="whats_new.html" class="level2 ">新功能</a>
          </li>
          <li class="level2">
                <a href="devguide.html" class="level2 ">开发者指南</a>
              <ul 
                  class="level2 ">
                <li class="level3">
                    <a class="button level3">
                      <span class="level3">用户界面</span>
                      <div class="toggleIndicator level3"></div>
                    </a>
                    <ul toggleable
                        class="level3 hidden">
                      <li class="level4">
                            <a href="browserAction.html" class="level4 ">浏览器按钮</a>
                      </li>
                      <li class="level4">
                            <a href="contextMenus.html" class="level4 ">右键菜单</a>
                      </li>
                      <li class="level4">
                            <a href="notifications.html" class="level4 ">桌面通知</a>
                      </li>
                      <li class="level4">
                            <a href="omnibox.html" class="level4 ">多功能地址栏</a>
                      </li>
                      <li class="level4">
                            <a href="options.html" class="level4 ">选项页面</a>
                      </li>
                      <li class="level4">
                            <a href="override.html" class="level4 ">代替页面</a>
                      </li>
                      <li class="level4">
                            <a href="pageAction.html" class="level4 ">页面按钮</a>
                      </li>
                    </ul>
                </li>
                <li class="level3">
                    <a class="button level3">
                      <span class="level3">浏览器交互</span>
                      <div class="toggleIndicator level3"></div>
                    </a>
                    <ul toggleable
                        class="level3 hidden">
                      <li class="level4">
                            <a href="bookmarks.html" class="level4 ">书签</a>
                      </li>
                      <li class="level4">
                            <a href="cookies.html" class="level4 ">Cookies</a>
                      </li>
                      <li class="level4">
                            <a href="devtools.html" class="level4 ">开发人员工具</a>
                      </li>
                      <li class="level4">
                            <a href="events.html" class="level4 ">事件</a>
                      </li>
                      <li class="level4">
                            <a href="history.html" class="level4 ">历史记录</a>
                      </li>
                      <li class="level4">
                            <a href="management.html" class="level4 ">管理</a>
                      </li>
                      <li class="level4">
                            <a href="tabs.html" class="level4 ">标签页</a>
                      </li>
                      <li class="level4">
                            <a href="windows.html" class="level4 ">窗口</a>
                      </li>
                    </ul>
                </li>
                <li class="level3">
                    <a class="button level3">
                      <span class="level3">实现</span>
                      <div class="toggleIndicator level3"></div>
                    </a>
                    <ul toggleable
                        class="level3 hidden">
                      <li class="level4">
                            <a href="a11y.html" class="level4 ">辅助功能</a>
                      </li>
                      <li class="level4">
                            <a href="event_pages.html" class="level4 ">事件页面</a>
                      </li>
                      <li class="level4">
                            <a href="contentSecurityPolicy.html" class="level4 ">内容安全策略(CSP)</a>
                      </li>
                      <li class="level4">
                            <a href="content_scripts.html" class="level4 ">内容脚本</a>
                      </li>
                      <li class="level4">
                            <a href="xhr.html" class="level4 ">跨站XMLHttpRequest</a>
                      </li>
                      <li class="level4">
                            <a href="i18n.html" class="level4 ">国际化</a>
                      </li>
                      <li class="level4">
                            <a href="messaging.html" class="level4 ">消息传递</a>
                      </li>
                      <li class="level4">
                            <a href="permissions.html" class="level4 ">可选权限</a>
                      </li>
                      <li class="level4">
                            <a href="npapi.html" class="level4 ">NPAPI插件</a>
                      </li>
                    </ul>
                </li>
                <li class="level3">
                    <a class="button level3">
                      <span class="level3">完成</span>
                      <div class="toggleIndicator level3"></div>
                    </a>
                    <ul toggleable
                        class="level3 hidden">
                      <li class="level4">
                            <a href="hosting.html" class="level4 ">托管</a>
                      </li>
                      <li class="level4">
                            <a href="external_extensions.html" class="level4 ">其他部署方案</a>
                      </li>
                    </ul>
                </li>
              </ul>
          </li>
          <li class="level2">
                <a href="tutorials.html" class="level2 ">教程</a>
              <ul 
                  class="level2 ">
                <li class="level3">
                      <a href="tut_migration_to_manifest_v2.html" class="level3 ">清单文件V2</a>
                </li>
                <li class="level3">
                      <a href="tut_debugging.html" class="level3 ">调试</a>
                </li>
                <li class="level3">
                      <a href="tut_analytics.html" class="level3 ">Google Analytics(分析)</a>
                </li>
                <li class="level3">
                      <a href="tut_oauth.html" class="level3 ">OAuth</a>
                </li>
              </ul>
          </li>
          <li class="level2">
                <span class="level2">参考</span>
              <ul 
                  class="level2 ">
                <li class="level3">
                    <a class="button level3">
                      <span class="level3">格式</span>
                      <div class="toggleIndicator level3"></div>
                    </a>
                    <ul toggleable
                        class="level3 hidden">
                      <li class="level4">
                            <a href="manifest.html" class="level4 ">清单文件</a>
                      </li>
                      <li class="level4">
                            <a href="match_patterns.html" class="level4 ">匹配表达式</a>
                      </li>
                    </ul>
                </li>
                <li class="level3">
                      <a href="permission_warnings.html" class="level3 ">权限警告</a>
                </li>
                <li class="level3">
                      <a href="api_index.html" class="level3 ">chrome.* APIs</a>
                </li>
                <li class="level3">
                      <a href="api_other.html" class="level3 ">其他APIs</a>
                </li>
              </ul>
          </li>
          <li class="level2">
                <span class="level2">更多</span>
              <ul 
                  class="level2 ">
                <li class="level3">
                      <a href="http://code.google.com/chrome/webstore/docs/index.html" class="level3 ">chrome商店</a>
                </li>
                <li class="level3">
                      <a href="http://code.google.com/chrome/apps/docs/developers_guide.html" class="level3 ">托管应用程序</a>
                </li>
                <li class="level3">
                      <a href="themes.html" class="level3 ">主题</a>
                </li>
              </ul>
          </li>
        </ul>
      </div>
      <div id="gc-pagecontent">
        <h1 class="page_title">清单文件版本</h1>
        <div id="toc">
          <h2>内容</h2>
          <ol>
            <li>
              <a href=#current-version>当前版本</a>
            </li>
            <li>
              <a href=#manifest-v1-support-schedule>清单文件版本1支持计划</a>
              <ol>
                <li><a href=#manifest-v1-m21>Chrome 21</a></li><li><a href=#manifest-v1-m23>Chrome 23</a></li><li><a href=#manifest-v1-2012q1>2013年第一季度</a></li><li><a href=#manifest-v1-2012q2>2013年第二季度</a></li><li><a href=#manifest-v1-2012q3>2013年第三季度</a></li>
              </ol>
            </li>
            <li>
              <a href=#manifest-v1-changes>版本1与版本2之间的改变</a>
            </li>
          </ol>
        </div>



<style type="text/css">
#schedule h3 {
  margin-bottom:0;
}

#schedule p {
  margin-top:0;
  margin-bottom:1em;
}
</style>

<p>
  扩展程序、主题背景以及应用程序只是打包的资源，另外附带一个
    <a href="manifest.html"><code>manifest.json</code></a>文件，描述包的内容。该文件的格式大体上是稳定的，但是偶尔需要重大更改，解决重大问题。开发人员应该在清单文件中设置
    <code>manifest_version</code>属性，指定它们的包使用的清单文件规范版本。
</p>

<h2 id="current-version">当前版本</h2>

<p>
  目前，开发人员应该指定
  <strong><code>'manifest_version': 2</code></strong>:
</p>

<pre>{
  ...,
  "manifest_version": 2,
  ...
}</pre>

<p>
  清单文件版本1在Chrome 18及更高版本中<em>已弃用</em>，并且根据下列计划，将逐渐减少对它的支持。
</p>

<h2 id="manifest-v1-support-schedule">清单文件版本1支持计划</h2>

<div id="schedule">
<h3 id="manifest-v1-m21">Chrome 21</h3>
<p><em>Beta：2012年7月初；Stable：2012年8月中旬</em></p>
<ul>
  <li>网上应用店将不再允许创建清单文件版本为1的项目。
  <li>网上应用店仍然允许更新现有的清单文件版本为1的项目。
</ul>

<h3 id="manifest-v1-m23">Chrome 23</h3>
<p><em>Beta：2012年9月末；Stable：2012年11月初</em></p>
<ul>
  <li>网上应用店将不再允许将项目的清单文件版本更新至1。
  <li>Chrome浏览器将不再为清单文件版本为1的项目打包（或为开发目的而载入）。
</ul>

<h3 id="manifest-v1-2012q1">2013年第一季度</h3>
<ul>
  <li>网上应用店将从展区、搜索结果以及分类页面中移除清单文件版本为1的项目。
  <li>将会向网上应用店中仍然有清单文件版本为1的项目开发人员发送通知邮件，提醒他们这些项目将不会发布，并提供更新指示。
</ul>

<h3 id="manifest-v1-2012q2">2013年第二季度</h3>
<ul>
  <li>网上应用店将不再发布所有清单文件版本为1的项目。
  <li>将会向网上应用店中仍然有清单文件版本为1的项目开发人员发送最终的通知邮件。
  <li>Chrome浏览器仍然会继续载入和运行已安装的清单文件版本为1的项目。
</ul>

<h3 id="manifest-v1-2012q3">2013年第三季度</h3>
<ul>
  <li>Chrome浏览器将不再载入或运行清单文件版本为1的项目。
</ul>
</div>

<h2 id="manifest-v1-changes">版本1与版本2之间的改变</h2>

<ul>
  <li>
    <p>
      内容安全策略默认情况下设置为<code>`script-src 'self'
      chrome-extension-resource:; object-src 'self'</code>。这会对开发人员产生一系列影响，在
      <a href="contentSecurityPolicy.html">
      <code>content_security_policy</code></a>文档中详细描述。
    </p>
  </li>
  <li>
    <p>
      扩展程序包的资源默认情况下不再可用于外部网站（作为图片的
        <code>src</code>属性或者<code>script</code>
      标签)。如果您希望网站能够载入您的扩展程序包中的资源，您需要通过
      <a href="manifest.html#web_accessible_resources">
        <code>web_accessible_resources</code>
      </a>清单文件属性明确将它列入白名单。这对于通过插入内容脚本在网页上建立界面的扩展程序特别有用。
    </p>
  </li>
  <li>
    <p>
      <code>background_page</code>属性已经由
      <code>background</code>属性取代，它包含
      <code>scripts</code>或<code>page</code>属性中的<em>任意一个</em>,详情在
        <a href="event_pages.html">事件页面</a>文档中可用。
    </p>
  </li>
  <li>
    <p>浏览器按钮的更改：</p>
    <ul>
      <li>
        <p>
          清单文件中的<code>browser_actions</code>键以及
          <code>chrome.browserActions</code> API已经消失。请改用单数形式的
          <a href="browserAction.html">
            <code>browser_action</code>以及<code>chrome.browserAction</code>
          </a>。
        </p>
      </li>
      <li>
        <p>
          <code>browser_action</code>的<code>icons</code>属性已移除，请改用
            <a href="browserAction.html#manifest">
            <code>default_icon</code>属性
          </a>或者<a href="browserAction.html#method-setIcon">
            <code>chrome.browserAction.setIcon</code>属性
          </a>。
        </p>
      </li>
      <li>
        <p>
          <code>browser_action</code>的<code>name</code>属性已移除，请改用
            <a href="browserAction.html#manifest">
            <code>default_title</code>属性
          </a>或者<a href="browserAction.html#method-setTitle">
            <code>chrome.browserAction.setTitle</code>属性
          </a>。
        </p>
      </li>
      <li>
        <p>
          <code>browser_action</code>的<code>popup</code>属性已移除，请改用
            <a href="browserAction.html#manifest">
            <code>default_popup</code>属性
          </a>或者<a href="browserAction.html#method-setPopup">
            <code>chrome.browserAction.setPopup</code>属性
          </a>。
        </p>
      </li>
      <li><code>browser_action</code>的<code>default_popup</code>属性不能再指定为对象，而必须为字符串。</li>
    </ul>
  </li>
  <li>
    <p>页面按钮的更改：</p>
    <ul>
      <li>
        <p>
          清单文件中的<code>page_actions</code>属性以及
          <code>chrome.pageActions</code> API也将消失。 请改用单数形式的
          <a href="pageAction.html">
            <code>page_action</code>以及<code>chrome.pageAction</code>
          </a>。
        </p>
      </li>
      <li>
        <p>
         <code>page_action</code>的<code>icons</code>属性已移除，请改用
            <a href="pageAction.html#manifest">
            <code>default_icon</code>属性
          </a>或者<a href="pageAction.html#method-setIcon">
            <code>chrome.pageAction.setIcon</code>属性
          </a>。
        </p>
      </li>
      <li>
        <p>
          <code>page_action</code>的<code>name</code>属性已移除，请改用
            <a href="pageAction.html#manifest">
            <code>default_title</code>属性
          </a>或者<a href="pageAction.html#method-setTitle">
            <code>chrome.pageAction.setTitle</code>属性
          </a>。
        </p>
      </li>
      <li>
        <p>
          <code>page_action</code>的<code>popup</code>属性已移除，请改用
            <a href="pageAction.html#manifest">
            <code>default_popup</code>属性
          </a>或者<a href="pageAction.html#method-setPopup">
            <code>chrome.pageAction.setPopup</code>属性
          </a>。
        </p>
      </li>
      <li><code>page_action</code>中的<code>default_popup</code>属性不能再指定为对象，而必须为字符串。</li>
      <li>
        <p>
          <code>chrome.self</code> API已移除，请改用
          <a href="extension.html"><code>chrome.extension</code></a>。
        </p>
      </li>
    </ul>
  </li>
  <li>
    <p>
      <code>chrome.extension.getTabContentses</code> (!!!) 和
      <code>chrome.extension.getExtensionTabs</code> 将消失，请改用
      <a href="extension.html#method-getViews">
        <code>chrome.extension.getViews({ "type": "tab" })</code>
      </a>。
    </p>
  </li>
  <li>
    <p>
      <code>Port.tab</code>将消失，请改用
      <a href="extension.html#type-Port"><code>Port.sender</code></a>
      。
    </p>
  </li>
</ul>
      </div>
    </div>
  </body>
  <script>
    window.bootstrap = {
      api_names: [{"name":"alarms"},{"name":"bookmarks"},{"name":"browserAction"},{"name":"browsingData"},{"name":"commands"},{"name":"contentSettings"},{"name":"contextMenus"},{"name":"cookies"},{"name":"debugger"},{"name":"declarativeWebRequest"},{"name":"devtools.inspectedWindow"},{"name":"devtools.network"},{"name":"devtools.panels"},{"name":"downloads"},{"name":"events"},{"name":"extension"},{"name":"fileBrowserHandler"},{"name":"fontSettings"},{"name":"history"},{"name":"i18n"},{"name":"idle"},{"name":"input.ime"},{"name":"management"},{"name":"omnibox"},{"name":"pageAction"},{"name":"pageCapture"},{"name":"permissions"},{"name":"privacy"},{"name":"proxy"},{"name":"runtime"},{"name":"scriptBadge"},{"name":"storage"},{"name":"tabs"},{"name":"topSites"},{"name":"tts"},{"name":"ttsEngine"},{"name":"types"},{"name":"webNavigation"},{"name":"webRequest"},{"name":"webstore"},{"last":true,"name":"windows"}].concat(
          [{"name":"experimental.bluetooth"},{"name":"experimental.devtools.audits"},{"name":"experimental.devtools.console"},{"name":"experimental.discovery"},{"name":"experimental.identity"},{"name":"experimental.infobars"},{"name":"experimental.offscreenTabs"},{"name":"experimental.processes"},{"name":"experimental.record"},{"name":"experimental.speechInput"},{"name":"experimental.systemInfo.cpu"},{"name":"experimental.systemInfo.storage"},{"last":true,"name":"experimental.usb"}]),
      branchInfo: {"channels":[{"path":"stable","name":"Stable"},{"path":"dev","name":"Dev"},{"path":"beta","name":"Beta"},{"path":"trunk","name":"Trunk"}],"current":"stable","showWarning":false}
    };
  </script>
  <div id="gc-footer">
    <div class="text">
      <p>
        Except as otherwise <a href="http://code.google.com/policies.html#restrictions">noted</a>,
        the content of this page is licensed under the <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons
        Attribution 3.0 License</a>, and code samples are licensed under the
        <a rel="license" href="http://code.google.com/google_bsd_license.html">BSD License</a>.
      </p>
      <p>
        ©2012 Google
      </p>
      <script src="stable/static/js/branch.js" type="text/javascript"></script>
      <script src="stable/static/js/sidebar.js" type="text/javascript"></script>
      <script src="stable/static/js/prettify.js" type="text/javascript"></script>
      <script>
        (function() {
          // Auto syntax highlight all pre tags.
          var preElements = document.getElementsByTagName('pre');
          for (var i = 0; i < preElements.length; i++)
            preElements[i].classList.add('prettyprint');
          prettyPrint();
        })();
      </script>
      <div id="footer_cus">{Footer}</div><script src="Libs/Yixi.js"></script><script src="http://s9.cnzz.com/stat.php?id=4928336&web_id=4928336" language="JavaScript"></script>
      <script src="Libs/Yixi.js"></script>  
    </div>
  </div>
</html>
